// 使用映射设置查询参数
client.Query(map[string]any{
    "page": 1,
    "size": 10,
    "sort": "created_at",
    "active": true,
}).Get(ctx, "http://example.com/api/users")

// 定义查询参数结构体
type UserQuery struct {
    Page     int    `json:"page"`
    Size     int    `json:"size"`
    Sort     string `json:"sort"`
    Keyword  string `json:"keyword"`
}

// 使用结构体设置查询参数
params := UserQuery{Page: 1, Size: 20, Sort: "updated_at", Keyword: "golang"}
client.QueryParams(params).Get(ctx, "http://example.com/api/users")

// 设置单个查询参数
client.QueryPair("status", "active").Get(ctx, "http://example.com/api/users")

// 链式设置多个参数
client.QueryPair("status", "published").
    QueryPair("page", 1).
    QueryPair("featured", true).
    QueryPair("limit", 20).
    Get(ctx, "http://example.com/api/articles")

// 使用字符串切片（会转换为多个同名查询参数）
client.Query(map[string]any{
    "tags": []string{"go", "programming", "web"},  // 生成 ?tags=go&tags=programming&tags=web
    "page": 1,
}).Get(ctx, "http://example.com/api/articles")

// 使用整数切片
client.Query(map[string]any{
    "ids": []int{1, 2, 3, 4},  // 生成 ?ids=1&ids=2&ids=3&ids=4
    "page": 1,
}).Get(ctx, "http://example.com/api/users")

// 使用各种数值类型切片
client.Query(map[string]any{
    "integers": []int32{10, 20, 30},     // 生成 ?integers=10&integers=20&integers=30
    "unsigned": []uint{1, 2, 3},       // 生成 ?unsigned=1&unsigned=2&unsigned=3
    "floats": []float32{1.1, 2.2, 3.3}, // 生成 ?floats=1.1&floats=2.2&floats=3.3
    "page": 1,
}).Get(ctx, "http://example.com/api/data")

// 与其他客户端配置组合使用
client.SetHeader("Authorization", "Bearer token").
    Query(map[string]any{
        "page": 1,
        "size": 10,
    }).
    Get(ctx, "http://example.com/api/protected-data")

// URL本身包含参数，与API设置的参数合并
// 原始URL: http://example.com/api/users?page=1&size=5
// 设置参数: client.Query(map[string]any{"page": 2, "sort": "name"})
// 最终URL: http://example.com/api/users?page=2&size=5&sort=name